home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / sgi.lha / Geomview / man / cat1 / polymerge.1 < prev    next >
Text File  |  1993-12-02  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. POLYMERGE(1)        UNIX Programmer's Manual         POLYMERGE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      polymerge - merge coincident vertices, collinear edges,
  10.      coplanar faces in an OOGL OFF object
  11.  
  12. SYNOPSIS
  13.      polymerge [-v vertex_thresh] [-e edge_thresh] [-f
  14.      face_thresh] [-V] [-E] [-F] [-d] [-b] [inputfile.off]
  15.  
  16. DESCRIPTION
  17.      Polymerge eliminates redundancies from polyhedral objects in
  18.      OOGL's OFF format, and writes another OFF object to its
  19.      standard output.  (Optionally it can produce instead an
  20.      input file for Brakke's Evolver.) Specifically, it combines
  21.      nearly-coincident vertices, nearly-collinear edges, and
  22.      nearly-coplanar faces.  Vertices which aren't used on any
  23.      face are deleted, as are faces with less than three ver-
  24.      tices.  Thresholds for approximate equality are adjustable
  25.      from the command line.  Options are:
  26.  
  27.      -v vertex_thresh
  28.           Merge vertices when they're closer than vertex_thresh
  29.           apart; the default is .00001.
  30.  
  31.      -V   Don't attempt to merge vertices.
  32.  
  33.      -e edge_thresh
  34.           Merge edges where |sin(vertex_angle)| < edge_thresh;
  35.           the default is When edges are merged, the corresponding
  36.           vertex is removed.
  37.  
  38.      -E   Don't attempt to merge edges.  (4OFF edges are never
  39.           merged.)
  40.  
  41.      -f face_thresh
  42.           Merge faces sharing an edge where the faces are nearly
  43.           coplanar: when |sin(angle_between_face_normal_vectors)|
  44.           < face_thresh.  The default is .03, or about two
  45.           degrees.  Note that merging can create faces which are
  46.           concave polygons.
  47.  
  48.      -F   Don't attempt to merge faces. (4OFF faces are never
  49.           merged.)
  50.  
  51.      -b   Produce an output file in .fe format for Brakke's Sur-
  52.           face Evolver, instead of a new OFF file.
  53.  
  54.      -d   Include debugging information as comments in the new
  55.           OFF object.  The comments indicate which vertices and
  56.           faces in the original object correspond to which in the
  57.           new one.  Messages include:
  58.  
  59.      # Vtx nnn->mmm
  60.           Merged vertices nnn and mmm (both indices in the origi-
  61.           nal object).
  62.  
  63.      # Merged face nnn into mmm (vertices vvv www) n1.n2 s
  64.           Faces nnn and mmm in the original object were merged;
  65.           their common edge joined original vertices vvv and www.
  66.           The cosine of the angle between the face normals was s.
  67.  
  68.      vertex coordinates  # newvertno [order] # oldvertno
  69.           Each vertex written appears with its new index, its
  70.           order (number of edges touching that vertex), and its
  71.           old index (index of a corresponding vertex in the ori-
  72.           ginal object).
  73.  
  74.      face description  # oldvertno ...
  75.           For each new face, with N vertices after reduction, the
  76.           comment indicates N corresponding vertices in the ori-
  77.           ginal object.
  78.  
  79. AUTHOR
  80.      Stuart Levy, Geometry Center, University of Minnesota
  81.  
  82. SEE ALSO
  83.      anytooff(1), offconsol(1)
  84.  
  85. BUGS
  86.      Coplanar faces are merged even if they were assigned dif-
  87.      ferent colors.  Should be able to handle binary OFF objects,
  88.      but this hasn't been tested.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.